Phase 1: ADK Onboarding journey revision #739
Conversation
joefernandez
commented
Oct 6, 2025
joefernandez
commented
- Quickstart: split by language and reduce time
- Build your agent: new section for agent building
- Home page: Simplify onboarding choices
- Surface "About ADK" in navigation
- Quickstart: split by language and reduce time - Build your agent: new section for agent building - Home page: Simplify onboarding choices - Surface "About ADK" in navigation
- completely revised Java quickstart
|
|
||
| ```shell | ||
| ```bash title="Update: my_agent/.env" | ||
| echo 'export GOOGLE_API_KEY="YOUR_API_KEY"' > .env |
There was a problem hiding this comment.
| echo 'export GOOGLE_API_KEY="YOUR_API_KEY"' > .env | |
| echo 'GOOGLE_API_KEY="YOUR_API_KEY"' > .env |
These are read in as key-value pairs, so no need to export to the current environment.
| === "MacOS / Linux" | ||
|
|
||
| ```bash title="Update: my_agent/.env" | ||
| echo 'export GOOGLE_API_KEY="YOUR_API_KEY"' > .env |
There was a problem hiding this comment.
| echo 'export GOOGLE_API_KEY="YOUR_API_KEY"' > .env | |
| echo 'GOOGLE_API_KEY="YOUR_API_KEY"' > .env |
There was a problem hiding this comment.
This image matches the output of the Java-based agent and tool, but the Python-based agent will return:
I am sorry, I cannot provide the time for London.
Should we use different images to match the output of each agent? Or refactor so the agent's tool implementation is the same and thus the output is the same?
|
|
||
|  | ||
| This command starts a web server with a chat interface for your agent. You can | ||
| access the web interface at (http://localhost:8080). Select the agent at the |
There was a problem hiding this comment.
| access the web interface at (http://localhost:8080). Select the agent at the | |
| access the web interface at (http://localhost:8000). Select the agent at the |
The default port in Python for adk web is 8000.
| This project uses the Gemini API, which requires an API key. If you | ||
| don't already have Gemini API key, create a key in Google AI Studio on the | ||
| [API Keys](https://aistudio.google.com/app/apikey) page. |
There was a problem hiding this comment.
| This project uses the Gemini API, which requires an API key. If you | |
| don't already have Gemini API key, create a key in Google AI Studio on the | |
| [API Keys](https://aistudio.google.com/app/apikey) page. | |
| This quickstart uses the Gemini API in Google AI Studio, which requires an API | |
| key. If you don't already have a Gemini API key, create a key in Google AI | |
| Studio on the [API Keys](https://aistudio.google.com/app/apikey) page. |
| src/main/java/com/example/agent/ | ||
| HelloTimeAgent.java # main agent code |
There was a problem hiding this comment.
| src/main/java/com/example/agent/ | |
| HelloTimeAgent.java # main agent code | |
| src/main/java/com/example/agent/HelloTimeAgent.java # main agent code |
Suggest unwrapping this line to remove ambiguity.
| Create an agent project with the following files and directory structure: | ||
|
|
||
| ```console | ||
| my_agent/ |
There was a problem hiding this comment.
Assuming that the my_agent/src/main/java/com/example/agent/AgentCliRunner.java file is a required / core part of the Java quickstart, should we add this file here as well to ensure its creation for later?
| ```console | ||
| mvn compile exec:java -Dexec.mainClass="com.example.agent.AgentCliRunner" | ||
| ``` |
There was a problem hiding this comment.
I tested this with ADK Java, and it's working as expected. Thanks!
| ```console | ||
| mvn compile exec:java -Dexec.mainClass="com.google.adk.web.AdkWebServer" \ | ||
| -Dexec.args="--adk.agents.source-dir=src/main/java/com/example/agent --server.port=8080" |
There was a problem hiding this comment.
I tested this and was unable to get it to detect the agent:
I tried running in different working directories, and I tried different source-dirs, but I couldn't get it to pull up the quickstart agent.
| - Java: get-started/streaming/quickstart-streaming-java.md | ||
| - Testing: get-started/testing.md | ||
| - Code samples: https://github.com/google/adk-samples | ||
| - Advanced setup: get-started/installation.md |
There was a problem hiding this comment.
In the contents of this page, do we want to update the pom.xml to match the latest versions shown on the Java quickstart page? Or should we go ahead and remove this page in this PR for now?
